home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / c / library / dos / communic / pcmail / main / gnuucp.ins < prev    next >
Encoding:
Text File  |  1994-06-05  |  4.9 KB  |  106 lines
  1. @(#) GNUUCP.ins 2.1 90/01/22 13:01:07
  2.  
  3. This document describes how to install the PC-mail software in an
  4. environment that uses GNUUCP as the message transport mechanism.  GNUUCP
  5. runs under more operating systems than just UNIX and MS-DOS, and offers
  6. far more features than the rather minimal "cico" program for dial-up
  7. and file transfer. The programs that interface between GNUUCP and PC-mail
  8. have undergone only little testing.
  9.  
  10. In order to use PC-mail in combination with GNUUCP, edit the makefile
  11. according to the directions given in that file (or execute the commands
  12. in the GNUUCP.bat file if you are using MS-DOS and do not have a decent
  13. make program).  This disables several features in the user interface
  14. program that are not needed when GNUUCP takes care of message transport.
  15. Under MS-DOS, make sure that the large memory model is selected.
  16.  
  17. Saying `make' should produce the following programs:
  18.  
  19.  - mail, the menu-driven user interface
  20.  - cmail, a program that checks if there is new mail
  21.  - smail, a program that queues messages for transmission after
  22.       doing alias substitution on mail addresses
  23.  - nmail, extracts "From" and "Subject" info from new mail
  24.  - gmail, searches the PC-mail messade data base for unsent mail,
  25.           and gives it to GNUUCP for delivery.  This program should
  26.           be invoked upon exit from the "mail" program (see the 
  27.       description of the MAILCMD enverionment variable lateron).
  28.  - lmail, installs mail received via GNUUCP into the PC-mail data base
  29.       Since this program is to invoked by the GNUUCP "rmail" program,
  30.       instead of the name "lmail" the program will probably have 
  31.       to be given a different name; this depends on how the GNUUCP 
  32.       "rmail" is configured.
  33.  
  34. The programs access a common data base in the form of a spool directory
  35. with a setup file and message files.  Optionally there may be an alias
  36. file, and header and trailer files to generate template messages.  There
  37. should be no other files in the spool directory, to avoid confusion.
  38. The spool directory should be created by hand; the PC-mail programs will
  39. not do that.
  40.  
  41. You will have to set some environment variables before running the mail
  42. programs.
  43.  
  44.  - MAILDIR, the location of your mail data base directory
  45.  - EDITOR, the name of your favourite editor program
  46.  - PATH, in order locate the PC-mail executables, and your editor
  47.  
  48. It is advised to use absolute path names that include the drive name.
  49. The editor command may be an MS-DOS batch file; in that case you should
  50. include the '.bat' suffix in the command name.
  51.  
  52. The following two environment variables are optional.
  53.  
  54.  - MAILPRN, the name of a file, if printer output should not go to 
  55.         the default printer.
  56.  - MAILCMD, a command that is executed  on  exit  from  the  mail
  57.         program. If this is an MS-DOS batch file you should 
  58.         include the `.bat' suffix in the command name.
  59.  
  60. At our site, these two variables are used to collect printer output in
  61. one file, and to send it to a networked printer upon exit from the
  62. program.  The MAILCMD feature can also be used to invoke the gmail
  63. program described above.
  64.  
  65. Make sure that the limit on the number of open files is large enough (20
  66. or so).  On MS-DOS, this is handled by a line with `files=20' in the
  67. CONFIG.SYS file.
  68.  
  69. On MS-DOS, the mail user interface requires the ANSI.SYS driver.  The
  70. CONFIG.SYS file should specify a line with "device=ansi.sys".
  71.  
  72. ALIAS DATABASE
  73.  
  74. The user can define aliases for (groups of) mail addresses.  The alias
  75. data base is a text file with on each line:
  76.  
  77.     alias replacement_part
  78.  
  79. The alias should be a single word; words are separated by blanks, tabs
  80. or commas.  The replacement part may be one or more words.  Whenever the
  81. smail (mail spooler) program recognizes an alias, it is replaced by the
  82. `replacement part'.  Aliases may be defined in terms of other aliases;
  83. the order in which they appear in the alias data base is not important
  84. (except when an alias is defined more than once; the program remembers
  85. only the last definition of an alias).  The alias expansion software is
  86. smart enough to detect infinite loops and to eliminate multiple
  87. occurrances of the same recipient.  Alias substitution is not case
  88. sensitive.
  89.  
  90. BATCH-MODE OPERATION
  91.  
  92. The cmail program can be run from a batch file (say, each time the PC is
  93. turned on), to report if there is new mail.  On multi-tasking machines,
  94. you may want to auto-execute the cmail command when exiting from the
  95. interactive mail shell (using the MAILCMD environment variable described
  96. above).
  97.  
  98. TEMPLATE FILES
  99.  
  100. The user can provide message templates with standard header and trailer
  101. lines.  If the file "header" is present in the mail directory, its
  102. contents will be included at the beginning of every mail message created
  103. by the user.  Similarly, the contents of a file "trailer" will be
  104. included at the end of mail messages.  The "header" and "trailer" files
  105. should be ordinary text files.
  106.